home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 2005 October / Computer Shopper 2005 October.iso / Toolkit / Internet / Ameol / A2542028.EXE / {app} / Addons / MODERATE.TXT < prev    next >
Encoding:
Text File  |  1995-06-23  |  14.4 KB  |  365 lines

  1. Installation notes for Moderate 1.01.0, the moderator addon for Ameol
  2.  
  3. ⌐ 1993-1995 CIX Ltd. All Rights Reserved.
  4.  
  5. This version of the addon is for Ameol/Ameol32 1.22 or later. It will *not*
  6. work with any earlier versions of Ameol.
  7.  
  8. Please report any problems or bugs in the moderate_beta conference.
  9.  
  10.  
  11. ARCHIVE CONTENTS
  12.  
  13. Moderate is distributed as self-extracting archives called M3210100.EXE
  14. for Ameol32 containing:
  15.  
  16.       MODERATE.TXT    this file
  17.       CHANGES.TXT     a list of changes in Moderate since a00.1
  18.       MODERA32.ADN    the Ameol moderator addon
  19.       MODERATE.HLP    the Moderate help file
  20.       HCTOOL32.DLL    support DLL (version 1.07.1)
  21.       WINHOR32.DLL    support DLL (version 2.06)
  22.       LIBRARYS.TXT    copyleft notice for HCTOOL32.DLL and WINHOR32.DLL
  23.       AMCTRL32.DLL    the Ameol32 common controls DLL
  24.  
  25. and M1610100.EXE for Ameol16 containing:
  26.  
  27.       MODERATE.TXT    this file
  28.       CHANGES.TXT     a list of changes in Moderate since a00.1
  29.       MODERATE.ADN    the Ameol moderator addon
  30.       MODERATE.HLP    the Moderate help file
  31.       HCTOOLS.DLL     support DLL (version 1.07.1)
  32.       WINHORUS.DLL    support DLL (version 2.06)
  33.       LIBRARYS.TXT    copyleft notice for HCTOOLS.DLL and WINHORUS.DLL
  34.       AMCTRLS.DLL     the Ameol common controls DLL
  35.  
  36.  
  37. INSTALLATION
  38.  
  39. MODERATE.ADN/MODERA32.ADN and MODERATE.HLP should be installed in your
  40. Ameol addons directory.
  41.  
  42. Moderate needs the support DLLs HCTOOLS.DLL/HCTOOL32.DLL (Ameol addon
  43. utility routines) version 1.07 or later and WINHORUS.DLL/WINHOR32.DLL
  44. (general Windows utility routines) version 2.06 or later. The latest
  45. versions can be downloaded from ameol_moderate/files. I suggest installing
  46. HCTools in your Ameol directory and WinHorus in your Windows system
  47. directory (~\windows\system, ~\winnt35\system32 or wherever). Note that
  48. these libraries are copylefted software; full source code is available on
  49. request or can be downloaded from ameol_moderate/files. The file
  50. LIBRARYS.TXT contains the copyleft agreement under which you are licenced
  51. to use them.
  52.  
  53. These versions of Moderate also require the Ameol common controls DLL
  54. (AMCTRLS.DLL/AMCTRL32.DLL). These will be included with Ameol/Ameol32 in
  55. the future, but for now they are included in the Moderate archives. The
  56. Ameol common controls DLL should be installed in your Windows system
  57. directory (~\windows\system, ~\winnt35\system32 or wherever).
  58.  
  59. Install the addon using the Settings/Utilities... menu entry. Click on the
  60. "Add" button and select MODERATE.ADN/MODERA32.ADN using the file selector
  61. that will appear, then click on "OK" in the Utilities dialog. The addon
  62. will appear in your Utilities menu; this entry displays version information
  63. and a list of Ameol menu entries installed by Moderate. These entries can
  64. also be activated from this "About" dialog using the buttons provided.
  65.  
  66. File list maintenance is installed as "Edit File Lists..." in the Ameol
  67. "Topic" menu.
  68.  
  69. CIX conference creation and topic maintenance are installed as "Create Host
  70. Conference..." in the Ameol "Global" menu and "Edit Host Topics..." in the
  71. Ameol "Topic" menu.
  72.  
  73. Various configurable settings in Moderate are editable from "Moderate..."
  74. in the Ameol "Settings" menu.
  75.  
  76. You may need to tell Ameol you moderate any conferences you want to use
  77. this addon with; either update the participant and moderator list using
  78. "Topic ╗ Participants..." or use the "Settings..." button in the Ameol
  79. topic list, with the appropriate conference name highlighted in the
  80. listbox, and type your CIX nickname into the "Moderators" edit box that
  81. appears and click "OK".
  82.  
  83.  
  84. CHANGES
  85.  
  86. 1.01.0 23rd June 1995
  87.       Final build for help file revision 9.
  88.  
  89. 1.01▀8 22nd June 1995
  90.       The file list editor dialog no longer flashes on the screen when
  91.       entry into the editor in cancelled.
  92.  
  93.       The file list editor conf/topic selector now remembers the last
  94.       topic selected between invocations of the editor.
  95.  
  96.       Help IDs changed to match the new help file.
  97.  
  98.       Bug 1.01.38 (Editing multiple line file list entries) fixed.
  99.       Bug 1.01.40 (Updating files using insert from upload) fixed.
  100.       Bug 1.01.42 (Erroneous disabling of update size checkbox) fixed.
  101.  
  102. 1.01▀7 13th June 1995
  103.       Popup help updated for the new format settings and file list editor
  104.       dialogs.
  105.  
  106.       Long filename support added for Moderate32.
  107.  
  108.       Changing the menu prefix flag in "Moderate ╗ Settings" now changes
  109.       the menus without Moderate needing to be restarted.
  110.  
  111.       File insertion entries in the Insert/Append/Update menus prefixed
  112.       with "From".
  113.  
  114.       Conference and topic names reinstated in the file list refresh
  115.       dialog.
  116.  
  117.       Description editor dialog title changed to "Edit file list entry".
  118.  
  119.       Bug 1.01.30 (Updating files from the flist editor) fixed.
  120.       Bug 1.01.32 (Incorrect flist editor control enabling) fixed.
  121.       Bug 1.01.34 (Errors erasing files from the fdir) fixed.
  122.       Bug 1.01.36 (Inserting dates in the description editor) fixed.
  123.       Bug 1.00.2  (Help button in common dialog file selectors) fixed.
  124.  
  125. 1.01▀6 26th May 1995
  126.       Moderate now recognises whether it is running under a registered or
  127.       unregistered copy of Ameol. The "OK" button in the conference
  128.       creation dialog is never enabled for evaluation use - a message box
  129.       informing the user of this is displayed on entry to the create
  130.       conference dialog. There is no longer a separate evaluation version
  131.       of Moderate.
  132.  
  133.       File list editor button and menu entries are now enabled or disabled
  134.       according to what entries are selected in the file list. Selections
  135.       in both the flist and fdir are maintained when switching tabs.
  136.  
  137.       Spacebar handling in the topic editor topic selector corrected to
  138.       work properly with Windows95 betas.
  139.  
  140.       Bug 1.01.26 (Inserting with right mouse button) fixed.
  141.       Bug 1.01.28 (Inserting files from the fdir tab) fixed.
  142.       Bug 1.00.8  (Empty mail directory) fixed.
  143.  
  144. 1.01▀5 1st May 1995
  145.       The Moderate setting dialog has been split into three property
  146.       sheets.
  147.  
  148.       The file description import facility now defaults to the .fls file
  149.       for the topic being edited, the default desc field is changed to 3.
  150.  
  151.       New settings flags have been added to disable the automatic recreation
  152.       of moderated topics that are deleted locally and to cause the file
  153.       list editor to automatically start the file notification code when
  154.       new entries are added.
  155.  
  156.       The initial check for unprocessed topic information files is now made
  157.       only if the Ameol "recover" flag is set.
  158.  
  159.       Added checking for characters with the top bit set in new conference
  160.       and topic name validation.
  161.  
  162.       Various routines made static as they should have been in the first
  163.       place.
  164.  
  165.       The settings dialog now displays a formatted example date above the
  166.       date format input field.
  167.  
  168.       The file list editor and file directory dialogs have been revamped
  169.       into a single tabbed dialog.
  170.  
  171.       The update topic information dialog now has a (one tab :) tab control
  172.       in anticipation of automatic flist information updating.
  173.  
  174.       Note that popup help is incorrect or missing for some dialog controls
  175.       in this beta.
  176.  
  177.       Bug 1.01.22 (Import file descriptions file selector is broken) fixed.
  178.       Bug 1.01.24 ("Add this topic?" selector broken) fixed.
  179.  
  180. 1.01▀4 8th March 1995
  181.       Bug 1.01.16 (Incorrect help page for download flists dialog) fixed.
  182.       Bug 1.01.17 (Non-functional controls in download flists dialog) fixed.
  183.       Bug 1.01.18 ("Update" button in topic maintenance doesn't work) fixed.
  184.  
  185. 1.01▀3 7th March 1995
  186.       "Cancel" button added to the new topic not added messagebox in both
  187.       conference creation and topic maintenance.
  188.  
  189.       Some generic functions moved to WinHorus.
  190.  
  191.       Bug 1.01.4  (Select Topic in Edit File List - Moderate32 only) fixed.
  192.  
  193. 1.01▀2 24th February 1995
  194.       The default for "menuprefix" changed to false.
  195.       New conference/topic names starting with a '.' are now rejected.
  196.       Version numbering changed to match that used by Ameol (a01=>1.01).
  197.       Checking for conf membership/moderatorship added to all scripts.
  198.  
  199.       Bug 1.00.3  (Conf creation failure) fixed.
  200.       Bug 1.00.4  (Conference with no topics) fixed.
  201.       Bug 1.01.2  (Right button pop up menus) fixed.
  202.       Bug 1.01.3  (Create Host Conference) fixed.
  203.       Bug 1.01.7  (Edit File List cancel...doesn't) fixed.
  204.       Bug 1.01.8  (Download file list twice) fixed.
  205.       Bug 1.01.9  (Date insertion in the description editor) fixed.
  206.       Bug 1.01.10 (Topic name validation in Edit Host Topics) fixed.
  207.  
  208. 1.01▀1 31st January 1995
  209.       All Moderate code rewritten to use message crackers and child
  210.       control macros and ported to Win32. All profile settings are now
  211.       written and read using the Ameol API routines so that they are stored
  212.       in the registry for Windows/NT and Windows95.
  213.  
  214.       Topic data processing optimised to speed up initialisation and
  215.       post-blink processing.
  216.  
  217. 1.00.1 5th October 1994
  218.       Bug 39 (file list update from upload fails) fixed.
  219.  
  220.       The "Edit Host Topics" dialog topic size panel now includes the
  221.       topic's %age full.
  222.  
  223.       The Ameol addons directory is now searched correctly for the
  224.       Moderate help file.
  225.  
  226.       The "Edit File List..." menu item has been moved from the bottom
  227.       of the "Topic" menu to the file manipulation group toward the top.
  228.  
  229.       Short cut key for "Update" in the file list editor changed to 'd'
  230.       to remove conflict with "Move up". The keys for "Update" and
  231.       "Update fdir" in the file directory display swapped for
  232.       consistency.
  233.  
  234. 1.00.0 30th September 1994
  235.  
  236.  
  237. KNOWN BUGS
  238.  
  239. 1.00.5 (Downloading and erasing files from the fdir)
  240.       If an fdir file is downloaded and erased in the same blink, the file
  241.       will be erased before an attempt is made to download it.
  242.  
  243.  
  244. CONFIGURATION
  245.  
  246. The following items are recognised in the [Moderate] section of ameol.ini
  247. (these can mostly be set using the "Settings ╗ Moderate..." dialog).
  248.  
  249. dateformat=%d%b%Y
  250.     The date insertion format is as per strftime(); the example above
  251.     shows the default setting. You can put in any plain text you like,
  252.     plus the following:
  253.  
  254.     %%      character %
  255.     %a      abbreviated weekday name
  256.     %A      full weekday name
  257.     %b      abbreviated month name
  258.     %B      full month name
  259.     %c      date and time, default format
  260.     %d      2-digit day of month (00-31)
  261.     %H      2-digit hour (00-23)
  262.     %I      2-digit hour (01-12)
  263.     %j      3-digit day of year (001-366)
  264.     %m      2-digit month as a decimal number (1-12)
  265.     %M      2-digit minute (00-59)
  266.     %p      AM or PM
  267.     %S      2-digit second (00-59)
  268.     %U      2-digit week number (Sunday first day of the week) (00-53)
  269.     %w      weekday where 0 is Sunday (0-6)
  270.     %W      2-digit week number (Monday first day of the week) (00-53)
  271.     %x      date, default format
  272.     %X      time, default format
  273.     %y      2-digit year without century (00-99)
  274.     %Y      year with century
  275.     %Z      time zone name, or no characters if no time zone
  276.  
  277. menuprefix=false
  278.     If this is set ("true", "on", "yes" or non-zero), menu entries
  279.     inserted into the Ameol menus by Moderate will be prefixed by "Mod: ".
  280.     The default for this is off.
  281.  
  282. fdirselect=0
  283.     This control the initial display state of the fdir window:
  284.  
  285.     0 -> orphans only
  286.     1 -> files in flist only
  287.     2 -> all files
  288.  
  289. fdirsort=descending date
  290.     This controls the initial sort options for fdir displays. The first
  291.     token can be 'ascending' or 'descending', the second 'name', 'date' or
  292.     'size'.
  293.  
  294. confirmdeletes=000
  295.     This is a three-digit decimal number:
  296.  
  297.     units: flist delete
  298.     0 -> confirm deletes
  299.     1 -> no confirmation of deletes
  300.     tens: flist fdir delete
  301.     0 -> do not delete files in fdir when removed from flist
  302.     1 -> confirm deletion of files in fdir when removed from flist
  303.     2 -> delete files in fdir without confirmation
  304.     hundreds: fdir delete
  305.     0 -> confirm all deletes
  306.     1 -> confirm deletes of flisted files
  307.     2 -> no confirmation of deletes
  308.  
  309. download=<path>
  310. upload=<path>
  311.     These are the local paths the addon will use for down/uploading
  312.     files. "upload" defaults to "download" which in turn defaults to
  313.     whatever "download" is set to in [Directories]. This is intended to
  314.     allow moderators to separate file list related file management from
  315.     their everyday CIXing.
  316.  
  317. notifysingle=true
  318.     This controls whether the default setting for notification messages for
  319.     mutiple files is to generate a single message for all files or to
  320.     generate a separate message for each file.
  321.  
  322. flistsort=ascending name
  323.     This controls the initial sort options for sorting an flist. The first
  324.     token can be 'ascending' or 'descending', the second 'name', 'date' or
  325.     'size'.
  326.  
  327. notifysignature=false
  328.     This controls whether notification messages will have a signature
  329.     automatically appended (if one is defined in Ameol).
  330.  
  331. editseed=false
  332.     If this is set, a message editor will be started automatically whenever
  333.     a new conference topic is created to allow the seed message to be
  334.     edited.
  335.  
  336. debug=off
  337.     Setting this to "on" enables some diagnostic code associated with topic
  338.     data updates in Moderate. This option cannot be set from "Settings..."
  339.  
  340. topicsizewarning=yes
  341.     This globally enables topic size warnings in Moderate. Warnings also
  342.     need to be defined and enabled per-topic.
  343.  
  344. notifysize=yes
  345.     If this is set, Moderate includes the file size (if known) in the
  346.     titles of file list notification messages.
  347.  
  348. notifycase=0
  349.     This sets the character case used for filenames in file list
  350.     notification messages. 0: lower case, 1: upper case, 2: mixed case.
  351.  
  352. commdlgbuffsize=4096
  353.     This sets the size in bytes of the filename buffer passed to the
  354.     commdlg file selector used for adding files to a file list by upload.
  355.     This option cannot be set from "Settings..."
  356.  
  357. autonotify=false
  358.     This controls whether the file notification message dialog is automatically
  359.     launched whenever files are added or updated in a file list.
  360.  
  361. createmissing=true
  362.     This controls whether Moderate automatically creates missing topics in
  363.     your local messagebase for conferences you moderate when performing
  364.     topic information updates.
  365.